    #
    # This is a CMake makefile.  You can find the cmake utility and
    # information about it at http://www.cmake.org
    #

    cmake_minimum_required(VERSION 3.10.0)

    set(CMAKE_DISABLE_SOURCE_CHANGES ON)
    set(CMAKE_DISABLE_IN_SOURCE_BUILD ON)

    if(POLICY CMP0077)
       cmake_policy(SET CMP0077 NEW)
    endif()

    project(dlib)

    set(CPACK_PACKAGE_NAME "dlib")
    set(CPACK_PACKAGE_VERSION_MAJOR "20")
    set(CPACK_PACKAGE_VERSION_MINOR "0")
    set(CPACK_PACKAGE_VERSION_PATCH "0")
    set(VERSION ${CPACK_PACKAGE_VERSION_MAJOR}.${CPACK_PACKAGE_VERSION_MINOR}.${CPACK_PACKAGE_VERSION_PATCH})
    # Only print these messages once, even if dlib is added multiple times via add_subdirectory()
    if (NOT TARGET dlib)
       message(STATUS "Using CMake version: ${CMAKE_VERSION}")
       message(STATUS "Compiling dlib version: ${VERSION}")
    endif()

    include(cmake_utils/set_compiler_specific_options.cmake)

    # Adhere to GNU filesystem layout conventions
    include(GNUInstallDirs)

    if (POLICY CMP0075)
       cmake_policy(SET CMP0075 NEW)
    endif()

    # default to a Release build (except if CMAKE_BUILD_TYPE is set)
    include(cmake_utils/release_build_by_default)

    # Set DLIB_VERSION in the including CMake file so they can use it to do whatever they want.
    get_directory_property(has_parent PARENT_DIRECTORY)
    if(has_parent)
       set(DLIB_VERSION ${VERSION} PARENT_SCOPE)
       if (NOT DEFINED DLIB_IN_PROJECT_BUILD)
          set(DLIB_IN_PROJECT_BUILD true)
       endif()
    endif()

    if (COMMAND pybind11_add_module AND MSVC)
       # True when building a python extension module using Visual Studio.  We care
       # about this because a huge number of windows users have broken systems, and
       # in particular, they have broken or incompatibly installed copies of things
       # like libjpeg or libpng.  So if we detect we are in this mode we will never
       # ever link to those libraries.  Instead, we link to the copy included with
       # dlib.
       set (BUILDING_PYTHON_IN_MSVC true)
    else()
       set (BUILDING_PYTHON_IN_MSVC false)
    endif()

    if (DLIB_IN_PROJECT_BUILD)

       # Check if we are being built as part of a pybind11 module.
       if (COMMAND pybind11_add_module)
          set(CMAKE_POSITION_INDEPENDENT_CODE True)
          if (CMAKE_COMPILER_IS_GNUCXX)
             # Just setting CMAKE_POSITION_INDEPENDENT_CODE should be enough to set
             # -fPIC for GCC but sometimes it still doesn't get set, so make sure it
             # does.
             add_definitions("-fPIC")
          endif()
          # Make DLIB_ASSERT statements not abort the python interpreter, but just return an error.
          list(APPEND active_preprocessor_switches "-DDLIB_NO_ABORT_ON_2ND_FATAL_ERROR")
       endif()

       # DLIB_IN_PROJECT_BUILD==true means you are using dlib by invoking
       # add_subdirectory(dlib) in the parent project. In this case, we always want
       # to build dlib as a static library so the parent project doesn't need to
       # deal with some random dlib shared library file.  It is much better to
       # statically compile dlib into the parent project.  So the following bit of
       # CMake ensures that happens.  However, we have to take care to compile dlib
       # with position independent code if appropriate (i.e. if the parent project
       # is a shared library).
       if (BUILD_SHARED_LIBS)
          if (CMAKE_COMPILER_IS_GNUCXX)
             # Just setting CMAKE_POSITION_INDEPENDENT_CODE should be enough to set
             # -fPIC for GCC but sometimes it still doesn't get set, so make sure it
             # does.
             add_definitions("-fPIC")
          endif()
          set(CMAKE_POSITION_INDEPENDENT_CODE true)
       endif()

       # Tell cmake to build dlib as a static library
       set(BUILD_SHARED_LIBS false)

    elseif(BUILD_SHARED_LIBS)
       if (MSVC)
          message(FATAL_ERROR "Building dlib as a standalone dll is not supported when using Visual Studio.  You are highly encouraged to use static linking instead.  See https://github.com/davisking/dlib/issues/1483 for a discussion.")
       endif()
    endif()

    if (CMAKE_VERSION VERSION_LESS "3.9.0")
       # Set only because there are old target_link_libraries() statements in the
       # FindCUDA.cmake file that comes with CMake that error out if the new behavior
       # is used.  In newer versions of CMake we can instead set CUDA_LINK_LIBRARIES_KEYWORD which fixes this issue.
       cmake_policy(SET CMP0023 OLD)
    else()
       set(CUDA_LINK_LIBRARIES_KEYWORD PUBLIC)
    endif()

    macro (enable_preprocessor_switch option_name)
       list(APPEND active_preprocessor_switches "-D${option_name}")
    endmacro()

    macro (disable_preprocessor_switch option_name)
       if (active_preprocessor_switches)
          list(REMOVE_ITEM active_preprocessor_switches "-D${option_name}")
       endif()
    endmacro()

    macro (toggle_preprocessor_switch option_name)
       if (${option_name})
          enable_preprocessor_switch(${option_name})
       else()
          disable_preprocessor_switch(${option_name})
       endif()
    endmacro()

    # Suppress superfluous randlib warnings about libdlib.a having no symbols on MacOSX.
    if (CMAKE_C_COMPILER_ID STREQUAL "AppleClang")
       set(CMAKE_C_ARCHIVE_CREATE   " Scr   ")
       set(CMAKE_C_ARCHIVE_FINISH   " -no_warning_for_no_symbols -c ")
    endif()
    if (CMAKE_CXX_COMPILER_ID STREQUAL "AppleClang")
       set(CMAKE_CXX_ARCHIVE_CREATE " Scr   ")
       set(CMAKE_CXX_ARCHIVE_FINISH " -no_warning_for_no_symbols -c ")
    endif()

    # Don't try to call add_library(dlib) and setup dlib's stuff if it has already
    # been done by some other part of the current cmake project.  We do this
    # because it avoids getting warnings/errors about cmake policy CMP0002.  This
    # happens when a project tries to call add_subdirectory() on dlib more than
    # once.  This most often happens when the top level of a project depends on two
    # or more other things which both depend on dlib.
    if (NOT TARGET dlib)

       set (DLIB_ISO_CPP_ONLY_STR
          "Enable this if you don't want to compile any non-ISO C++ code (i.e. you don't use any of the API Wrappers)" )
       set (DLIB_NO_GUI_SUPPORT_STR
          "Enable this if you don't want to compile any of the dlib GUI code" )
       set (DLIB_ENABLE_STACK_TRACE_STR
          "Enable this if you want to turn on the DLIB_STACK_TRACE macros" )
       set (DLIB_USE_BLAS_STR
          "Disable this if you don't want to use a BLAS library" )
       set (DLIB_USE_LAPACK_STR
          "Disable this if you don't want to use a LAPACK library" )
       set (DLIB_USE_CUDA_STR
          "Disable this if you don't want to use NVIDIA CUDA" )
       set (DLIB_USE_CUDA_COMPUTE_CAPABILITIES_STR
          "Set this to a comma-separated list of CUDA compute capabilities" )
       set (DLIB_USE_MKL_SEQUENTIAL_STR
          "Enable this if you have MKL installed and want to use the sequential version instead of the multi-core version." )
       set (DLIB_USE_MKL_WITH_TBB_STR
          "Enable this if you have MKL installed and want to use the tbb version instead of the openmp version." )
       set (DLIB_PNG_SUPPORT_STR
          "Disable this if you don't want to link against libpng" )
       set (DLIB_GIF_SUPPORT_STR
          "Disable this if you don't want to link against libgif" )
       set (DLIB_JPEG_SUPPORT_STR
          "Disable this if you don't want to link against libjpeg" )
       set (DLIB_WEBP_SUPPORT_STR
          "Disable this if you don't want to link against libwebp" )
       set (DLIB_JXL_SUPPORT_STR
          "Disable this if you don't want to link against libjxl" )
       set (DLIB_LINK_WITH_SQLITE3_STR
          "Disable this if you don't want to link against sqlite3" )
       #set (DLIB_USE_FFTW_STR "Disable this if you don't want to link against fftw" )
       set (DLIB_USE_MKL_FFT_STR
          "Disable this is you don't want to use the MKL DFTI FFT implementation" )
       set (DLIB_ENABLE_ASSERTS_STR
          "Enable this if you want to turn on the DLIB_ASSERT macro" )
       set (DLIB_USE_FFMPEG_STR
          "Disable this if you don't want to use the FFMPEG library" )

       option(DLIB_ENABLE_ASSERTS ${DLIB_ENABLE_ASSERTS_STR} OFF)
       option(DLIB_ISO_CPP_ONLY ${DLIB_ISO_CPP_ONLY_STR} OFF)
       toggle_preprocessor_switch(DLIB_ISO_CPP_ONLY)
       option(DLIB_NO_GUI_SUPPORT ${DLIB_NO_GUI_SUPPORT_STR} OFF)
       toggle_preprocessor_switch(DLIB_NO_GUI_SUPPORT)
       option(DLIB_ENABLE_STACK_TRACE ${DLIB_ENABLE_STACK_TRACE_STR} OFF)
       toggle_preprocessor_switch(DLIB_ENABLE_STACK_TRACE)
       option(DLIB_USE_MKL_SEQUENTIAL ${DLIB_USE_MKL_SEQUENTIAL_STR} OFF)
       option(DLIB_USE_MKL_WITH_TBB ${DLIB_USE_MKL_WITH_TBB_STR} OFF)

       if(DLIB_ENABLE_ASSERTS)
          # Set these variables so they are set in the config.h.in file when dlib
          # is installed.
          set (DLIB_DISABLE_ASSERTS false)
          set (ENABLE_ASSERTS true)
          enable_preprocessor_switch(ENABLE_ASSERTS)
          disable_preprocessor_switch(DLIB_DISABLE_ASSERTS)
       else()
          # Set these variables so they are set in the config.h.in file when dlib
          # is installed.
          set (DLIB_DISABLE_ASSERTS true)
          set (ENABLE_ASSERTS false)
          disable_preprocessor_switch(ENABLE_ASSERTS)
          # Never force the asserts off when doing an in project build.  The only
          # time this matters is when using visual studio.  The visual studio IDE
          # has a drop down that lets the user select either release or debug
          # builds.  The DLIB_ASSERT macro is setup to enable/disable automatically
          # based on this drop down (via preprocessor magic).  However, if
          # DLIB_DISABLE_ASSERTS is defined it permanently disables asserts no
          # matter what, which would defeat the visual studio drop down.  So here
          # we make a point to not do that kind of severe disabling when in a
          # project build.  It should also be pointed out that DLIB_DISABLE_ASSERTS
          # is only needed when building and installing dlib as a separately
          # installed library.  It doesn't matter when doing an in project build.
          if (NOT DLIB_IN_PROJECT_BUILD)
             enable_preprocessor_switch(DLIB_DISABLE_ASSERTS)
          endif()
       endif()

       if (DLIB_ISO_CPP_ONLY)
          option(DLIB_JPEG_SUPPORT ${DLIB_JPEG_SUPPORT_STR} OFF)
          option(DLIB_LINK_WITH_SQLITE3 ${DLIB_LINK_WITH_SQLITE3_STR} OFF)
          option(DLIB_USE_BLAS ${DLIB_USE_BLAS_STR} OFF)
          option(DLIB_USE_LAPACK ${DLIB_USE_LAPACK_STR} OFF)
          option(DLIB_USE_CUDA ${DLIB_USE_CUDA_STR} OFF)
          option(DLIB_PNG_SUPPORT ${DLIB_PNG_SUPPORT_STR} OFF)
          option(DLIB_GIF_SUPPORT ${DLIB_GIF_SUPPORT_STR} OFF)
          option(DLIB_WEBP_SUPPORT ${DLIB_WEBP_SUPPORT_STR} OFF)
          option(DLIB_JXL_SUPPORT ${DLIB_JXL_SUPPORT_STR} OFF)
          #option(DLIB_USE_FFTW ${DLIB_USE_FFTW_STR} OFF)
          option(DLIB_USE_MKL_FFT ${DLIB_USE_MKL_FFT_STR} OFF)
          option(DLIB_USE_FFMPEG ${DLIB_USE_FFMPEG_STR} OFF)
       else()
          option(DLIB_JPEG_SUPPORT ${DLIB_JPEG_SUPPORT_STR} ON)
          option(DLIB_LINK_WITH_SQLITE3 ${DLIB_LINK_WITH_SQLITE3_STR} ON)
          option(DLIB_USE_BLAS ${DLIB_USE_BLAS_STR} ON)
          option(DLIB_USE_LAPACK ${DLIB_USE_LAPACK_STR} ON)
          option(DLIB_USE_CUDA ${DLIB_USE_CUDA_STR} ON)
          set(DLIB_USE_CUDA_COMPUTE_CAPABILITIES 50 CACHE STRING ${DLIB_USE_CUDA_COMPUTE_CAPABILITIES_STR})
          option(DLIB_PNG_SUPPORT ${DLIB_PNG_SUPPORT_STR} ON)
          option(DLIB_GIF_SUPPORT ${DLIB_GIF_SUPPORT_STR} ON)
          option(DLIB_WEBP_SUPPORT ${DLIB_WEBP_SUPPORT_STR} ON)
          option(DLIB_JXL_SUPPORT ${DLIB_JXL_SUPPORT_STR} ON)
          #option(DLIB_USE_FFTW ${DLIB_USE_FFTW_STR} ON)
          option(DLIB_USE_MKL_FFT ${DLIB_USE_MKL_FFT_STR} ON)
          option(DLIB_USE_FFMPEG ${DLIB_USE_FFMPEG_STR} ON)
       endif()
       toggle_preprocessor_switch(DLIB_JPEG_SUPPORT)
       toggle_preprocessor_switch(DLIB_USE_BLAS)
       toggle_preprocessor_switch(DLIB_USE_LAPACK)
       toggle_preprocessor_switch(DLIB_USE_CUDA)
       toggle_preprocessor_switch(DLIB_PNG_SUPPORT)
       toggle_preprocessor_switch(DLIB_GIF_SUPPORT)
       toggle_preprocessor_switch(DLIB_WEBP_SUPPORT)
       toggle_preprocessor_switch(DLIB_JXL_SUPPORT)
       #toggle_preprocessor_switch(DLIB_USE_FFTW)
       toggle_preprocessor_switch(DLIB_USE_MKL_FFT)
       toggle_preprocessor_switch(DLIB_USE_FFMPEG)

       set(source_files
          base64/base64_kernel_1.cpp
          bigint/bigint_kernel_1.cpp
          bigint/bigint_kernel_2.cpp
          bit_stream/bit_stream_kernel_1.cpp
          entropy_decoder/entropy_decoder_kernel_1.cpp
          entropy_decoder/entropy_decoder_kernel_2.cpp
          entropy_encoder/entropy_encoder_kernel_1.cpp
          entropy_encoder/entropy_encoder_kernel_2.cpp
          md5/md5_kernel_1.cpp
          tokenizer/tokenizer_kernel_1.cpp
          unicode/unicode.cpp
          test_for_odr_violations.cpp
          fft/fft.cpp
          )

       set(dlib_needed_public_libraries)
       set(dlib_needed_public_includes)
       set(dlib_needed_public_cflags)
       set(dlib_needed_public_ldflags)
       set(dlib_needed_private_libraries)
       set(dlib_needed_private_includes)

       if (DLIB_ISO_CPP_ONLY)
          add_library(dlib ${source_files} )
       else()

          set(source_files ${source_files}
             sockets/sockets_kernel_1.cpp
             bsp/bsp.cpp
             dir_nav/dir_nav_kernel_1.cpp
             dir_nav/dir_nav_kernel_2.cpp
             dir_nav/dir_nav_extensions.cpp
             gui_widgets/fonts.cpp
             linker/linker_kernel_1.cpp
             logger/extra_logger_headers.cpp
             logger/logger_kernel_1.cpp
             logger/logger_config_file.cpp
             misc_api/misc_api_kernel_1.cpp
             misc_api/misc_api_kernel_2.cpp
             sockets/sockets_extensions.cpp
             sockets/sockets_kernel_2.cpp
             sockstreambuf/sockstreambuf.cpp
             sockstreambuf/sockstreambuf_unbuffered.cpp
             server/server_kernel.cpp
             server/server_iostream.cpp
             server/server_http.cpp
             threads/multithreaded_object_extension.cpp
             threads/threaded_object_extension.cpp
             threads/threads_kernel_1.cpp
             threads/threads_kernel_2.cpp
             threads/threads_kernel_shared.cpp
             threads/thread_pool_extension.cpp
             threads/async.cpp
             timer/timer.cpp
             stack_trace.cpp
             cuda/cpu_dlib.cpp
             cuda/tensor_tools.cpp
             data_io/image_dataset_metadata.cpp
             data_io/mnist.cpp
             data_io/cifar.cpp
             global_optimization/global_function_search.cpp
             filtering/kalman_filter.cpp
             svm/auto.cpp
             )

          if(UNIX)
             set(CMAKE_THREAD_PREFER_PTHREAD ON)
             find_package(Threads REQUIRED)
             list (APPEND dlib_needed_private_libraries ${CMAKE_THREAD_LIBS_INIT})
          endif()

          # we want to link to the right stuff depending on our platform.
          if (WIN32 AND NOT CYGWIN) ###############################################################################
             if (DLIB_NO_GUI_SUPPORT)
                list (APPEND dlib_needed_private_libraries ws2_32 winmm)
             else()
                list (APPEND dlib_needed_private_libraries ws2_32 winmm comctl32 gdi32 imm32)
             endif()
          elseif(APPLE) ############################################################################
             set(CMAKE_MACOSX_RPATH 1)
             if (NOT DLIB_NO_GUI_SUPPORT)
                find_package(X11 QUIET)
                if (X11_FOUND)
                   # If both X11 and anaconda are installed, it's possible for the
                   # anaconda path to appear before /opt/X11, so we remove anaconda.
                   foreach (ITR ${X11_INCLUDE_DIR})
                      if ("${ITR}" MATCHES "(.*)(Ana|ana|mini)conda(.*)")
                         list (REMOVE_ITEM X11_INCLUDE_DIR ${ITR})
                      endif ()
                   endforeach(ITR)
                   list (APPEND dlib_needed_public_includes ${X11_INCLUDE_DIR})
                   list (APPEND dlib_needed_public_libraries ${X11_LIBRARIES})
                else()
                   find_library(xlib X11)
                   # Make sure X11 is in the include path.  Note that we look for
                   # Xlocale.h rather than Xlib.h because it avoids finding a partial
                   # copy of the X11 headers on systems with anaconda installed.
                   find_path(xlib_path Xlocale.h
                      PATHS
                      /Developer/SDKs/MacOSX10.4u.sdk/usr/X11R6/include
                      /opt/local/include
                      PATH_SUFFIXES X11
                      )
                   if (xlib AND xlib_path)
                      get_filename_component(x11_path ${xlib_path} PATH CACHE)
                      list (APPEND dlib_needed_public_includes ${x11_path})
                      list (APPEND dlib_needed_public_libraries ${xlib})
                      set(X11_FOUND 1)
                   endif()
                endif()
                if (NOT X11_FOUND)
                   message(" *****************************************************************************")
                   message(" *** DLIB GUI SUPPORT DISABLED BECAUSE X11 DEVELOPMENT LIBRARIES NOT FOUND ***")
                   message(" *** Make sure XQuartz is installed if you want GUI support.               ***")
                   message(" *** You can download XQuartz from: https://www.xquartz.org/               ***")
                   message(" *****************************************************************************")
                   set(DLIB_NO_GUI_SUPPORT ON CACHE STRING ${DLIB_NO_GUI_SUPPORT_STR} FORCE )
                   enable_preprocessor_switch(DLIB_NO_GUI_SUPPORT)
                endif()
             endif()

             mark_as_advanced(xlib xlib_path x11_path)
          else () ##################################################################################
             # link to the socket library if it exists.  this is something you need on solaris
             find_library(socketlib socket)
             if (socketlib)
                list (APPEND dlib_needed_private_libraries ${socketlib})
             endif ()

             if (NOT DLIB_NO_GUI_SUPPORT)
                include(FindX11)
                if (X11_FOUND)
                   list (APPEND dlib_needed_private_includes ${X11_INCLUDE_DIR})
                   list (APPEND dlib_needed_private_libraries ${X11_LIBRARIES})
                else()
                   message(" *****************************************************************************")
                   message(" *** DLIB GUI SUPPORT DISABLED BECAUSE X11 DEVELOPMENT LIBRARIES NOT FOUND ***")
                   message(" *** Make sure libx11-dev is installed if you want GUI support.            ***")
                   message(" *** On Ubuntu run: sudo apt-get install libx11-dev                        ***")
                   message(" *****************************************************************************")
                   set(DLIB_NO_GUI_SUPPORT ON CACHE STRING ${DLIB_NO_GUI_SUPPORT_STR} FORCE )
                   enable_preprocessor_switch(DLIB_NO_GUI_SUPPORT)
                endif()
             endif()

             mark_as_advanced(nsllib socketlib)
          endif () ##################################################################################

          if (NOT DLIB_NO_GUI_SUPPORT)
             set(source_files ${source_files}
                gui_widgets/widgets.cpp
                gui_widgets/drawable.cpp
                gui_widgets/canvas_drawing.cpp
                gui_widgets/style.cpp
                gui_widgets/base_widgets.cpp
                gui_core/gui_core_kernel_1.cpp
                gui_core/gui_core_kernel_2.cpp
                )
          endif()

          INCLUDE (CheckFunctionExists)

          if (DLIB_GIF_SUPPORT)
             find_package(GIF QUIET)
             if (GIF_FOUND)
                list (APPEND dlib_needed_public_includes ${GIF_INCLUDE_DIR})
                list (APPEND dlib_needed_public_libraries ${GIF_LIBRARY})
             else()
                set(DLIB_GIF_SUPPORT OFF CACHE STRING ${DLIB_GIF_SUPPORT_STR} FORCE )
                toggle_preprocessor_switch(DLIB_GIF_SUPPORT)
             endif()
          endif()

          if (DLIB_PNG_SUPPORT)
             include(cmake_utils/find_libpng.cmake)
             if (PNG_FOUND)
                list (APPEND dlib_needed_private_includes ${PNG_INCLUDE_DIR})
                list (APPEND dlib_needed_private_libraries ${PNG_LIBRARIES})
             else()
                # If we can't find libpng then statically compile it in.
                include_directories(external/libpng external/zlib)
                set(source_files ${source_files}
                   external/libpng/arm/arm_init.c
                   external/libpng/arm/filter_neon_intrinsics.c
                   external/libpng/arm/palette_neon_intrinsics.c
                   external/libpng/png.c
                   external/libpng/pngerror.c
                   external/libpng/pngget.c
                   external/libpng/pngmem.c
                   external/libpng/pngpread.c
                   external/libpng/pngread.c
                   external/libpng/pngrio.c
                   external/libpng/pngrtran.c
                   external/libpng/pngrutil.c
                   external/libpng/pngset.c
                   external/libpng/pngtrans.c
                   external/libpng/pngwio.c
                   external/libpng/pngwrite.c
                   external/libpng/pngwtran.c
                   external/libpng/pngwutil.c
                   external/zlib/adler32.c
                   external/zlib/compress.c
                   external/zlib/crc32.c
                   external/zlib/deflate.c
                   external/zlib/gzclose.c
                   external/zlib/gzlib.c
                   external/zlib/gzread.c
                   external/zlib/gzwrite.c
                   external/zlib/infback.c
                   external/zlib/inffast.c
                   external/zlib/inflate.c
                   external/zlib/inftrees.c
                   external/zlib/trees.c
                   external/zlib/uncompr.c
                   external/zlib/zutil.c
                   )

                include(cmake_utils/check_if_neon_available.cmake)
                if (ARM_NEON_IS_AVAILABLE)
                   message (STATUS "NEON instructions will be used for libpng.")
                   enable_language(ASM)
                   set(source_files ${source_files}
                      external/libpng/arm/arm_init.c
                      external/libpng/arm/filter_neon_intrinsics.c
                      external/libpng/arm/filter_neon.S
                      )
                   set_source_files_properties(external/libpng/arm/filter_neon.S PROPERTIES COMPILE_FLAGS "${CMAKE_ASM_FLAGS} ${CMAKE_CXX_FLAGS} -x assembler-with-cpp")
                endif()
             endif()
             set(source_files ${source_files}
                image_loader/png_loader.cpp
                image_saver/save_png.cpp
                )
          endif()

          if (DLIB_JPEG_SUPPORT)
             include(cmake_utils/find_libjpeg.cmake)
             if (JPEG_FOUND)
                list (APPEND dlib_needed_private_includes ${JPEG_INCLUDE_DIR})
                list (APPEND dlib_needed_private_libraries ${JPEG_LIBRARY})
             else()
                # If we can't find libjpeg then statically compile it in.
                add_definitions(-DDLIB_JPEG_STATIC)
                set(source_files ${source_files}
                  external/libjpeg/jaricom.c
                  external/libjpeg/jcapimin.c
                  external/libjpeg/jcapistd.c
                  external/libjpeg/jcarith.c
                  external/libjpeg/jccoefct.c
                  external/libjpeg/jccolor.c
                  external/libjpeg/jcdctmgr.c
                  external/libjpeg/jchuff.c
                  external/libjpeg/jcinit.c
                  external/libjpeg/jcmainct.c
                  external/libjpeg/jcmarker.c
                  external/libjpeg/jcmaster.c
                  external/libjpeg/jcomapi.c
                  external/libjpeg/jcparam.c
                  external/libjpeg/jcprepct.c
                  external/libjpeg/jcsample.c
                  external/libjpeg/jdapimin.c
                  external/libjpeg/jdapistd.c
                  external/libjpeg/jdarith.c
                  external/libjpeg/jdatadst.c
                  external/libjpeg/jdatasrc.c
                  external/libjpeg/jdcoefct.c
                  external/libjpeg/jdcolor.c
                  external/libjpeg/jddctmgr.c
                  external/libjpeg/jdhuff.c
                  external/libjpeg/jdinput.c
                  external/libjpeg/jdmainct.c
                  external/libjpeg/jdmarker.c
                  external/libjpeg/jdmaster.c
                  external/libjpeg/jdmerge.c
                  external/libjpeg/jdpostct.c
                  external/libjpeg/jdsample.c
                  external/libjpeg/jerror.c
                  external/libjpeg/jfdctflt.c
                  external/libjpeg/jfdctfst.c
                  external/libjpeg/jfdctint.c
                  external/libjpeg/jidctflt.c
                  external/libjpeg/jidctfst.c
                  external/libjpeg/jidctint.c
                  external/libjpeg/jmemmgr.c
                  external/libjpeg/jmemnobs.c
                  external/libjpeg/jquant1.c
                  external/libjpeg/jquant2.c
                  external/libjpeg/jutils.c
                   )
             endif()
             set(source_files ${source_files}
                image_loader/jpeg_loader.cpp
                image_saver/save_jpeg.cpp
                )
          endif()
          if (DLIB_WEBP_SUPPORT)
             include(cmake_utils/find_libwebp.cmake)
             if (WEBP_FOUND)
                list (APPEND dlib_needed_private_includes ${WEBP_INCLUDE_DIR})
                list (APPEND dlib_needed_private_libraries ${WEBP_LIBRARY})
                set(source_files ${source_files}
                   image_loader/webp_loader.cpp
                   image_saver/save_webp.cpp
                   )
             else()
                 set(DLIB_WEBP_SUPPORT OFF CACHE BOOL ${DLIB_WEBP_SUPPORT_STR} FORCE )
                 toggle_preprocessor_switch(DLIB_WEBP_SUPPORT)
             endif()
          endif()
          if (DLIB_JXL_SUPPORT)
             include(cmake_utils/find_libjxl.cmake)
             if (JXL_FOUND)
                list (APPEND dlib_needed_private_includes ${JXL_INCLUDE_DIRS})
                list (APPEND dlib_needed_private_libraries ${JXL_LIBRARIES})
                list (APPEND dlib_needed_public_cflags ${JXL_CFLAGS})
                list (APPEND dlib_needed_public_ldflags ${JXL_LDFLAGS})
                set(source_files ${source_files}
                   image_loader/jxl_loader.cpp
                   image_saver/save_jxl.cpp
                   )
                enable_preprocessor_switch(DLIB_JXL_SUPPORT)
             else()
                set(DLIB_JXL_SUPPORT OFF CACHE BOOL ${DLIB_JXL_SUPPORT_STR} FORCE)
                disable_preprocessor_switch(DLIB_JXL_SUPPORT)
             endif()
          endif()

          if (DLIB_USE_BLAS OR DLIB_USE_LAPACK OR DLIB_USE_MKL_FFT)
             if (DLIB_USE_MKL_WITH_TBB AND DLIB_USE_MKL_SEQUENTIAL)
                set(DLIB_USE_MKL_SEQUENTIAL OFF CACHE STRING ${DLIB_USE_MKL_SEQUENTIAL_STR} FORCE )
                toggle_preprocessor_switch(DLIB_USE_MKL_SEQUENTIAL)
                message(STATUS "Disabling DLIB_USE_MKL_SEQUENTIAL. It cannot be used simultaneously with DLIB_USE_MKL_WITH_TBB.")
             endif()

             # Try to find BLAS, LAPACK and MKL
             include(cmake_utils/find_blas.cmake)

             if (DLIB_USE_BLAS)
                if (blas_found)
                   list (APPEND dlib_needed_public_libraries ${blas_libraries})
                else()
                   set(DLIB_USE_BLAS OFF CACHE STRING ${DLIB_USE_BLAS_STR} FORCE )
                   toggle_preprocessor_switch(DLIB_USE_BLAS)
                endif()
             endif()

             if (DLIB_USE_LAPACK)
                if (lapack_found)
                   list (APPEND dlib_needed_public_libraries ${lapack_libraries})
                   if (lapack_with_underscore)
                      set(LAPACK_FORCE_UNDERSCORE 1)
                      enable_preprocessor_switch(LAPACK_FORCE_UNDERSCORE)
                   elseif (lapack_without_underscore)
                      set(LAPACK_FORCE_NOUNDERSCORE 1)
                      enable_preprocessor_switch(LAPACK_FORCE_NOUNDERSCORE)
                   endif ()
                else()
                   set(DLIB_USE_LAPACK OFF CACHE STRING ${DLIB_USE_LAPACK_STR} FORCE )
                   toggle_preprocessor_switch(DLIB_USE_LAPACK)
                endif()
             endif()

             if (DLIB_USE_MKL_FFT)
                if (found_intel_mkl AND found_intel_mkl_headers)
                   list (APPEND dlib_needed_public_includes ${mkl_include_dir})
                   list (APPEND dlib_needed_public_libraries ${mkl_libraries})
                else()
                   set(DLIB_USE_MKL_FFT OFF CACHE STRING ${DLIB_USE_MKL_FFT_STR} FORCE )
                   toggle_preprocessor_switch(DLIB_USE_MKL_FFT)
                endif()
             endif()
          endif()

          if (DLIB_USE_CUDA)
             find_package(CUDA 7.5)

             if (CUDA_VERSION VERSION_GREATER 9.1 AND CMAKE_VERSION VERSION_LESS 3.12.2)
                # This bit of weirdness is to work around a bug in cmake
                list(REMOVE_ITEM CUDA_CUBLAS_LIBRARIES "CUDA_cublas_device_LIBRARY-NOTFOUND")
             endif()

             if (CUDA_FOUND AND MSVC AND NOT CUDA_CUBLAS_LIBRARIES AND "${CMAKE_SIZEOF_VOID_P}" EQUAL "4")
                message(WARNING "You have CUDA installed, but we can't use it unless you put visual studio in 64bit mode.")
                set(CUDA_FOUND 0)
             endif()

             if (NOT CUDA_CUBLAS_LIBRARIES)
                message(STATUS "Found CUDA, but CMake was unable to find the cuBLAS libraries that should be part of every basic CUDA "
                   "install. Your CUDA install is somehow broken or incomplete. Since cuBLAS is required for dlib to use CUDA we won't use CUDA.")
                set(CUDA_FOUND 0)
             endif()

             if (CUDA_FOUND)

                # There is some bug in cmake that causes it to mess up the
                # -std=c++11 option if you let it propagate it to nvcc in some
                # cases.  So instead we disable this and manually include
                # things from CMAKE_CXX_FLAGS in the CUDA_NVCC_FLAGS list below.
                if (APPLE)
                   set(CUDA_PROPAGATE_HOST_FLAGS OFF)
                   # Grab all the -D flags from CMAKE_CXX_FLAGS so we can pass them
                   # to nvcc.
                   string(REGEX MATCHALL "-D[^ ]*" FLAGS_FOR_NVCC "${CMAKE_CXX_FLAGS}")

                   # Check if we are being built as part of a pybind11 module.
                   if (COMMAND pybind11_add_module)
                      # Don't export unnecessary symbols.
                      list(APPEND FLAGS_FOR_NVCC "-Xcompiler=-fvisibility=hidden")
                   endif()
                endif()

                set(CUDA_HOST_COMPILATION_CPP ON)
                string(REPLACE "," ";" DLIB_CUDA_COMPUTE_CAPABILITIES ${DLIB_USE_CUDA_COMPUTE_CAPABILITIES})
                foreach(CAP ${DLIB_CUDA_COMPUTE_CAPABILITIES})
                    list(APPEND CUDA_NVCC_FLAGS "-gencode arch=compute_${CAP},code=[sm_${CAP},compute_${CAP}]")
                endforeach()
                # Note that we add __STRICT_ANSI__ to avoid freaking out nvcc with gcc specific
                # magic in the standard C++ header files (since nvcc uses gcc headers on linux).
                list(APPEND CUDA_NVCC_FLAGS "-D__STRICT_ANSI__;-D_MWAITXINTRIN_H_INCLUDED;-D_FORCE_INLINES;${FLAGS_FOR_NVCC}")
                list(APPEND CUDA_NVCC_FLAGS ${active_preprocessor_switches})
                if (NOT DLIB_IN_PROJECT_BUILD)
                   LIST(APPEND CUDA_NVCC_FLAGS -DDLIB__CMAKE_GENERATED_A_CONFIG_H_FILE)
                endif()
                if (NOT MSVC)
                   list(APPEND CUDA_NVCC_FLAGS "-std=c++14")
                endif()
                if (CMAKE_POSITION_INDEPENDENT_CODE)
                   # sometimes this setting isn't propagated to NVCC, which then causes the
                   # compile to fail.  So make sure it's propagated.
                   if (NOT MSVC) # Visual studio doesn't have -fPIC so don't do it in that case.
                      list(APPEND CUDA_NVCC_FLAGS "-Xcompiler -fPIC")
                   endif()
                endif()

                include(cmake_utils/test_for_cudnn/find_cudnn.txt)

                if (cudnn AND cudnn_include AND NOT DEFINED cuda_test_compile_worked AND NOT DEFINED cudnn_test_compile_worked)
                   # make sure cuda is really working by doing a test compile
                   message(STATUS "Building a CUDA test project to see if your compiler is compatible with CUDA...")

                   set(CUDA_TEST_CMAKE_FLAGS
                      "-DCMAKE_PREFIX_PATH=${CMAKE_PREFIX_PATH}"
                      "-DCMAKE_INCLUDE_PATH=${CMAKE_INCLUDE_PATH}"
                      "-DCMAKE_LIBRARY_PATH=${CMAKE_LIBRARY_PATH}")

                   if (NOT MSVC) # see https://github.com/davisking/dlib/issues/363
                      list(APPEND CUDA_TEST_CMAKE_FLAGS "-DCUDA_HOST_COMPILER=${CUDA_HOST_COMPILER}")
                   endif()

                   try_compile(cuda_test_compile_worked
                      ${PROJECT_BINARY_DIR}/cuda_test_build
                      ${PROJECT_SOURCE_DIR}/cmake_utils/test_for_cuda cuda_test
                      CMAKE_FLAGS ${CUDA_TEST_CMAKE_FLAGS}
                      OUTPUT_VARIABLE try_compile_output_message
                      )
                   if (NOT cuda_test_compile_worked)
                      string(REPLACE "\n" "\n   ***   " try_compile_output_message "${try_compile_output_message}")
                      message(STATUS "*****************************************************************************************************************")
                      message(STATUS "*** CUDA was found but your compiler failed to compile a simple CUDA program so dlib isn't going to use CUDA. ")
                      message(STATUS "*** The output of the failed CUDA test compile is shown below: ")
                      message(STATUS "*** ")
                      message(STATUS "***   ${try_compile_output_message}")
                      message(STATUS "*****************************************************************************************************************")
                   else()
                      message(STATUS "Building a cuDNN test project to check if you have the right version of cuDNN installed...")
                      try_compile(cudnn_test_compile_worked
                         ${PROJECT_BINARY_DIR}/cudnn_test_build
                         ${PROJECT_SOURCE_DIR}/cmake_utils/test_for_cudnn cudnn_test
                         CMAKE_FLAGS ${CUDA_TEST_CMAKE_FLAGS}
                         OUTPUT_VARIABLE try_compile_output_message
                         )
                      if (NOT cudnn_test_compile_worked)
                         string(REPLACE "\n" "\n   ***   " try_compile_output_message "${try_compile_output_message}")
                         message(STATUS "*****************************************************************************************************")
                         message(STATUS "*** Found cuDNN, but we failed to compile the dlib/cmake_utils/test_for_cudnn project. ")
                         message(STATUS "*** You either have an unsupported version of cuDNN or something is wrong with your cudDNN install.")
                         message(STATUS "*** Since a functional cuDNN is not found DLIB WILL NOT USE CUDA. ")
                         message(STATUS "*** The output of the failed test_for_cudnn build is: ")
                         message(STATUS "*** ")
                         message(STATUS "***   ${try_compile_output_message}")
                         message(STATUS "*****************************************************************************************************")
                      endif()
                   endif()
                endif()

                # Find where cuSOLVER is since the FindCUDA cmake package doesn't
                # bother to look for it in older versions of cmake.
                if (NOT CUDA_cusolver_LIBRARY)
                   get_filename_component(cuda_blas_path "${CUDA_CUBLAS_LIBRARIES}" DIRECTORY)
                   find_library(CUDA_cusolver_LIBRARY cusolver HINTS ${cuda_blas_path})
                   # CUDA 10.1 doesn't install symbolic links to libcusolver.so in
                   # the usual place.  This is probably a bug in the cuda
                   # installer.  In any case, If we haven't found cusolver yet go
                   # look in the cuda install folder for it.  New versions of cmake
                   # do this correctly, but older versions need help.
                   if (NOT CUDA_cusolver_LIBRARY)
                      find_library(CUDA_cusolver_LIBRARY cusolver HINTS
                         /usr/local/cuda/lib64/
                         )
                   endif()
                   mark_as_advanced(CUDA_cusolver_LIBRARY)
                endif()
                # Also find OpenMP since cuSOLVER needs it.  Importantly, we only
                # look for one to link to if our use of BLAS, specifically the
                # Intel MKL, hasn't already decided what to use.  This is because
                # it makes the MKL bug out if you link to another openmp lib other
                # than Intel's when you use the MKL. I'm also not really sure when
                # explicit linking to openmp became unnecessary, but for
                # sufficiently older versions of cuda it was needed.  Then in
                # versions of cmake newer than 3.11 linking to openmp started to
                # mess up the switches passed to nvcc, so you can't just leave
                # these "try to link to openmp" statements here going forward.  Fun
                # times.
                if (CUDA_VERSION VERSION_LESS "9.1" AND NOT openmp_libraries AND NOT MSVC AND NOT XCODE AND NOT APPLE)
                   find_package(OpenMP)
                   if (OPENMP_FOUND)
                      set(openmp_libraries ${OpenMP_CXX_FLAGS})
                   else()
                      message(STATUS "*** Didn't find OpenMP, which is required to use CUDA. ***")
                      set(CUDA_FOUND 0)
                   endif()
                endif()
             endif()

             if (CUDA_FOUND AND cudnn AND cuda_test_compile_worked AND cudnn_test_compile_worked AND cudnn_include)
                set(source_files ${source_files}
                   cuda/cuda_dlib.cu
                   cuda/cudnn_dlibapi.cpp
                   cuda/cublas_dlibapi.cpp
                   cuda/cusolver_dlibapi.cu
                   cuda/curand_dlibapi.cpp
                   cuda/cuda_data_ptr.cpp
                   cuda/gpu_data.cpp
                   )
                list (APPEND dlib_needed_private_libraries ${CUDA_CUBLAS_LIBRARIES})
                list (APPEND dlib_needed_private_libraries ${cudnn})
                list (APPEND dlib_needed_private_libraries ${CUDA_curand_LIBRARY})
                list (APPEND dlib_needed_private_libraries ${CUDA_cusolver_LIBRARY})
                list (APPEND dlib_needed_private_libraries ${CUDA_CUDART_LIBRARY})
                if(openmp_libraries)
                   list (APPEND dlib_needed_private_libraries ${openmp_libraries})
                endif()

                include_directories(${cudnn_include})
                message(STATUS "Enabling CUDA support for dlib.  DLIB WILL USE CUDA, compute capabilities: ${DLIB_CUDA_COMPUTE_CAPABILITIES}")
             else()
                set(DLIB_USE_CUDA OFF CACHE STRING ${DLIB_USE_BLAS_STR} FORCE )
                toggle_preprocessor_switch(DLIB_USE_CUDA)
                if (NOT CUDA_FOUND)
                   message(STATUS "DID NOT FIND CUDA")
                endif()
                message(STATUS "Disabling CUDA support for dlib.  DLIB WILL NOT USE CUDA")
             endif()
          endif()

          if (DLIB_LINK_WITH_SQLITE3)
             find_library(sqlite sqlite3)
             # make sure sqlite3.h is in the include path
             find_path(sqlite_path sqlite3.h)
             if (sqlite AND sqlite_path)
                list (APPEND dlib_needed_public_includes ${sqlite_path})
                list (APPEND dlib_needed_public_libraries ${sqlite} )
             else()
                set(DLIB_LINK_WITH_SQLITE3 OFF CACHE STRING ${DLIB_LINK_WITH_SQLITE3_STR} FORCE )
             endif()
             mark_as_advanced(sqlite sqlite_path)
          endif()

          if (DLIB_USE_FFTW)
             find_library(fftw fftw3)
             # make sure fftw3.h is in the include path
             find_path(fftw_path fftw3.h)
             if (fftw AND fftw_path)
               list (APPEND dlib_needed_private_includes ${fftw_path})
               list (APPEND dlib_needed_private_libraries ${fftw})
             else()
                set(DLIB_USE_FFTW OFF CACHE STRING ${DLIB_USE_FFTW_STR} FORCE )
                toggle_preprocessor_switch(DLIB_USE_FFTW)
             endif()
             mark_as_advanced(fftw fftw_path)
          endif()

          if (DLIB_USE_FFMPEG)
             include(cmake_utils/find_ffmpeg.cmake)
             if (FFMPEG_FOUND)
                list (APPEND dlib_needed_public_includes ${FFMPEG_INCLUDE_DIRS})
                list (APPEND dlib_needed_public_libraries ${FFMPEG_LINK_LIBRARIES})
                list (APPEND dlib_needed_public_cflags ${FFMPEG_CFLAGS})
                list (APPEND dlib_needed_public_ldflags ${FFMPEG_LDFLAGS})
                enable_preprocessor_switch(DLIB_USE_FFMPEG)
             else()
                set(DLIB_USE_FFMPEG OFF CACHE BOOL ${DLIB_USE_FFMPEG_STR} FORCE )
                disable_preprocessor_switch(DLIB_USE_FFMPEG)
             endif()
          endif()

          # Tell CMake to build dlib via add_library()/cuda_add_library()
          if (DLIB_USE_CUDA)
             # The old cuda_add_library() command doesn't support CMake's newer dependency
             # stuff, so we have to set the include path manually still, which we do here.
             include_directories(${dlib_needed_public_includes})
             cuda_add_library(dlib ${source_files} )
          else()
             add_library(dlib ${source_files} )
          endif()

       endif ()  ##### end of if NOT DLIB_ISO_CPP_ONLY ##########################################################

       target_include_directories(dlib
          INTERFACE $CMAKE_CURRENT_SOURCE_DIR}/..>
          INTERFACE $
          PUBLIC ${dlib_needed_public_includes}
          PRIVATE ${dlib_needed_private_includes}
          )
       target_link_libraries(dlib PUBLIC ${dlib_needed_public_libraries} ${dlib_needed_public_ldflags})
       target_link_libraries(dlib PRIVATE ${dlib_needed_private_libraries})
       target_compile_options(dlib PUBLIC ${dlib_needed_public_cflags})
       if (DLIB_IN_PROJECT_BUILD)
          target_compile_options(dlib PUBLIC ${active_preprocessor_switches})
       else()
          # These are private in this case because they will be controlled by the
          # contents of dlib/config.h once it's installed. But for in project
          # builds, there is no real config.h so they are public in the above case.
          target_compile_options(dlib PRIVATE ${active_preprocessor_switches})
          # Do this so that dlib/config.h won't set DLIB_NOT_CONFIGURED. This will then allow
          # the code in dlib/threads_kernel_shared.cpp to emit a linker error for users who
          # don't use the configured config.h file generated by cmake.
          target_compile_options(dlib PRIVATE -DDLIB__CMAKE_GENERATED_A_CONFIG_H_FILE)

          # Do this so that dlib/config.h can record the version of dlib it's configured with
          # and ultimately issue a linker error to people who try to use a binary dlib that is
          # the wrong version.
          set(DLIB_CHECK_FOR_VERSION_MISMATCH
             DLIB_VERSION_MISMATCH_CHECK__EXPECTED_VERSION_${CPACK_PACKAGE_VERSION_MAJOR}_${CPACK_PACKAGE_VERSION_MINOR}_${CPACK_PACKAGE_VERSION_PATCH})
          target_compile_options(dlib PRIVATE "-DDLIB_CHECK_FOR_VERSION_MISMATCH=${DLIB_CHECK_FOR_VERSION_MISMATCH}")
       endif()

       # Allow the unit tests to ask us to compile the all/source.cpp file just to make sure it compiles.
       if (DLIB_TEST_COMPILE_ALL_SOURCE_CPP)
          add_library(dlib_all_source_cpp STATIC all/source.cpp)
          target_link_libraries(dlib_all_source_cpp dlib)
          target_compile_options(dlib_all_source_cpp PUBLIC ${active_preprocessor_switches})
          target_compile_features(dlib_all_source_cpp PUBLIC cxx_std_14)
       endif()

       target_compile_features(dlib PUBLIC cxx_std_14)
       if((MSVC AND CMAKE_VERSION VERSION_LESS 3.11))
          target_compile_options(dlib PUBLIC ${active_compile_opts})
          target_compile_options(dlib PRIVATE ${active_compile_opts_private})
       else()
          target_compile_options(dlib PUBLIC $<$:${active_compile_opts}>)
          target_compile_options(dlib PRIVATE $<$:${active_compile_opts_private}>)
       endif()

       # Install the library
       if (NOT DLIB_IN_PROJECT_BUILD)
          string (REPLACE ";" " " pkg_config_dlib_needed_libraries "${dlib_needed_public_libraries}")
          # Make the -I include options for pkg-config
          foreach (ITR ${dlib_needed_public_includes})
             set (pkg_config_dlib_needed_includes "${pkg_config_dlib_needed_includes} -I${ITR}")
          endforeach()
          set_target_properties(dlib PROPERTIES
             VERSION ${VERSION})
          install(TARGETS dlib
             EXPORT dlib
             RUNTIME DESTINATION ${CMAKE_INSTALL_BINDIR} # Windows considers .dll to be runtime artifacts
             LIBRARY DESTINATION ${CMAKE_INSTALL_LIBDIR}
             ARCHIVE DESTINATION ${CMAKE_INSTALL_LIBDIR})

          install(DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR}/ DESTINATION ${CMAKE_INSTALL_INCLUDEDIR}/dlib
             FILES_MATCHING
                PATTERN "*.h"
                PATTERN "*.cmake"
                PATTERN "*_tutorial.txt"
                PATTERN "cassert"
                PATTERN "cstring"
                PATTERN "fstream"
                PATTERN "iomanip"
                PATTERN "iosfwd"
                PATTERN "iostream"
                PATTERN "istream"
                PATTERN "locale"
                PATTERN "ostream"
                PATTERN "sstream"
                REGEX "${CMAKE_CURRENT_BINARY_DIR}" EXCLUDE)

          configure_file(${PROJECT_SOURCE_DIR}/config.h.in ${CMAKE_CURRENT_BINARY_DIR}/config.h)
          # overwrite config.h with the configured one
          install(FILES ${CMAKE_CURRENT_BINARY_DIR}/config.h DESTINATION ${CMAKE_INSTALL_INCLUDEDIR}/dlib)

          configure_file(${PROJECT_SOURCE_DIR}/revision.h.in ${CMAKE_CURRENT_BINARY_DIR}/revision.h)
          install(FILES ${CMAKE_CURRENT_BINARY_DIR}/revision.h DESTINATION ${CMAKE_INSTALL_INCLUDEDIR}/dlib)

          ## Config.cmake generation and installation

          set(ConfigPackageLocation "${CMAKE_INSTALL_LIBDIR}/cmake/dlib")
          install(EXPORT dlib
             NAMESPACE dlib::
             DESTINATION ${ConfigPackageLocation})

          configure_file(cmake_utils/dlibConfig.cmake.in "${CMAKE_CURRENT_BINARY_DIR}/config/dlibConfig.cmake" @ONLY)

          include(CMakePackageConfigHelpers)
          write_basic_package_version_file(
             "${CMAKE_CURRENT_BINARY_DIR}/config/dlibConfigVersion.cmake"
             VERSION ${VERSION}
             COMPATIBILITY AnyNewerVersion
             )

          install(FILES
             "${CMAKE_CURRENT_BINARY_DIR}/config/dlibConfig.cmake"
             "${CMAKE_CURRENT_BINARY_DIR}/config/dlibConfigVersion.cmake"
             DESTINATION ${ConfigPackageLocation})

          ## dlib-1.pc generation and installation

          configure_file("cmake_utils/dlib.pc.in" "dlib-1.pc" @ONLY)
          install(FILES "${CMAKE_CURRENT_BINARY_DIR}/dlib-1.pc"
             DESTINATION "${CMAKE_INSTALL_LIBDIR}/pkgconfig")

          # Add a cpack "package" target. This will create an archive containing
          # the built library file, the header files, and cmake and pkgconfig
          # configuration files.
          include(CPack)

       endif()

    endif()

    if (MSVC)
       # Give the output library files names that are unique functions of the
       # visual studio mode that compiled them.  We do this so that people who
       # compile dlib and then copy the .lib files around (which they shouldn't be
       # doing in the first place!) will hopefully be slightly less confused by
       # what happens since, at the very least, the filenames will indicate what
       # visual studio runtime they go with.
       math(EXPR numbits ${CMAKE_SIZEOF_VOID_P}*8)
       set_target_properties(dlib PROPERTIES DEBUG_POSTFIX "${VERSION}_debug_${numbits}bit_msvc${MSVC_VERSION}")
       set_target_properties(dlib PROPERTIES RELEASE_POSTFIX "${VERSION}_release_${numbits}bit_msvc${MSVC_VERSION}")
       set_target_properties(dlib PROPERTIES MINSIZEREL_POSTFIX "${VERSION}_minsizerel_${numbits}bit_msvc${MSVC_VERSION}")
       set_target_properties(dlib PROPERTIES RELWITHDEBINFO_POSTFIX "${VERSION}_relwithdebinfo_${numbits}bit_msvc${MSVC_VERSION}")
    endif()

    # Check if we are being built as part of a pybind11 module.
    if (COMMAND pybind11_add_module)
       # Don't export unnecessary symbols.
       set_target_properties(dlib PROPERTIES CXX_VISIBILITY_PRESET "hidden")
       set_target_properties(dlib PROPERTIES CUDA_VISIBILITY_PRESET "hidden")
    endif()

    if (WIN32 AND mkl_iomp_dll)
       # If we are using the Intel MKL on windows then try and copy the iomp dll
       # file to the output folder.  We do this since a very large number of
       # windows users don't understand that they need to add the Intel MKL's
       # folders to their PATH to use the Intel MKL.  They then complain on the
       # dlib forums.  Copying the Intel MKL dlls to the output directory removes
       # the need to add the Intel MKL to the PATH.
       if (CMAKE_LIBRARY_OUTPUT_DIRECTORY)
          add_custom_command(TARGET dlib POST_BUILD
             # In some newer versions of windows/visual studio the output Config folder doesn't
             # exist at first, so you can't copy to it unless you make it yourself.  So make
             # sure the target folder exists first.
             COMMAND ${CMAKE_COMMAND} -E make_directory "${CMAKE_LIBRARY_OUTPUT_DIRECTORY}/"
             COMMAND ${CMAKE_COMMAND} -E copy "${mkl_iomp_dll}" "${CMAKE_LIBRARY_OUTPUT_DIRECTORY}/"
             )
       else()
          add_custom_command(TARGET dlib POST_BUILD
             # In some newer versions of windows/visual studio the output Config folder doesn't
             # exist at first, so you can't copy to it unless you make it yourself.  So make
             # sure the target folder exists first.
             COMMAND ${CMAKE_COMMAND} -E make_directory "${CMAKE_BINARY_DIR}/$/"
             COMMAND ${CMAKE_COMMAND} -E copy "${mkl_iomp_dll}" "${CMAKE_BINARY_DIR}/$/"
             )
       endif()
    endif()

    add_library(dlib::dlib ALIAS dlib)